合并工程

合并工程时，您可以重用在其他工程中创建的资源和节点。合并工程让您可以导入一个完整的工程或仅选定的资源和节点。合并期间，Kanzi 提供冲突解决方案。

Kanzi 提供以下选项引入其他工程中的内容：

• 您可以将整个工程引入当前工程。请参阅导入工程。
• 您可以合并 3D 资产文件中的 3D 资产。请参阅合并 3D 资产。
• 您可以仅将另一工程的一部分引入当前工程。请参阅合并引用的 Kanzi Studio 工程中的内容。
• 如果要导入使用第三方工具创建的内容，请使用 Kanzi Studio 导入工具。请参阅导入。

合并工程

要合并工程：

1. 选择文件 (File) > 导入 (Import) > 合并工程 (Merge Project)，选择您要合并到当前已打开工程（目标工程）的工程（源工程），然后点击打开 (Open)。
   工程合并 (Project Merge) 对话框即会打开。
   
2. 在工程合并 (Project Merge) 对话框中设置：
   • 选择已引用项 (Select referenced items)。要让 Kanzi Studio 自动选择选定项引用的所有项，选中复选框。
     例如，选中选择已引用项 (Select referenced items) 复选框并选择具有材质的网格时，Kanzi Studio studio 会自动选择所选网格使用的材质、材质类型和着色器。
   • 变换。如果用源中的对象替换目标中的对象时Kanzi Studio 遇到对象变换冲突，将保持变换自 (Keep transformations from) 设为：
     • 目标工程 (Target Project): <ProjectName>，保留在目标中使用的对象变换。Kanzi Studio 会记住您对Kanzi Studio 中的对象所做的所有变换更改。
     • 源工程 (Source Project): <ProjectName>，导入在源中使用的对象变换。
     
   • 材质 (Materials)。如果用源中的对象替换目标中的对象时，Kanzi Studio 遇到对象材质冲突，将保持材质来自 (Keep materials from) 设为：
     • 目标工程 (Target Project): <ProjectName>，保留您对目标中的对象使用的材质。Kanzi Studio 会记住您对 Kanzi Studio 中的对象所做的所有材质更改。
     • 源工程 (Source Project): <ProjectName>，导入您对源中的对象使用的材质。
     
3. 选中您要从源合并到目标的项旁边的复选框。根据选定项在目标工程中的存在情况，项的名称作如下区分：
   • 白色 字体。项存在于源中，但不在目标中。您选择这些项时，Kanzi Studio 在目标中创建它们。
   • 红色 (Red) 字体。项存在于源和目标中，且在两者中不同。
     您必须选择使用目标还是源中的项来解决冲突，才能继续合并。
   • 紫色 字体。项存在于目标中，但不在源中。您选择这些项后，Kanzi Studio 会将其从目标中移除。
4. 如果要合并包含使用本地存储数据的数据源的工程，请参阅合并包含使用本地存储数据的数据源的工程。
5. 如果您要合并包含 Kanzi Engine 插件 (Kanzi Engine Plugins) 的工程，请参阅合并包含 Kanzi Engine 插件的工程。
6. 解决冲突。目标和源都包含相同的项但项属性不同时，您必须决定要保留哪些属性：
   • 点击解析至源 (Resolve to source) 使用源中的值来解决所有冲突。
   • 点击解析至目标 (Resolve to target) 使用目标中的值来解决所有冲突。
   • 点击使用基准工程 (Use base project) 选择一个基准工程来解决目标和源之间的冲突。例如，在合并作为初始工程修改的两个工程或资产时，使用基准工程 (Use base project) 非常有用。
     使用三路合并时，Kanzi Studio 中的冲突解决方式如下：
     • 如果差异仅限于基准工程和目标之间，Kanzi Studio 使用目标中的更改。
     • 如果差异仅限于基准工程和源之间，Kanzi Studio 使用源中的更改。
     • 如果在基准工程和目标之间以及源和目标之间都有更改，则必须解决冲突。
   • 要手动解决冲突，选择源树中的项，并在冲突窗格中为每个属性选择要保留目标还是源中使用的值。
     • 您可以选择多个属性并点击解析至目标 (Resolve to Target) 以保留目标中使用的值，或点击解析至源 (Resolve to Source) 以保留源中使用的值。
       
     • 您可以从目标 (Target) 或源 (Source) 列中选择您要保留的单个值。
       

   解决所有冲突后，源树中项名称的字体颜色将变为绿色。

7. 点击合并 (Merge)。
   Kanzi Studio 将源的内容放到目标的相应位置来合并源和目标。

合并包含 Kanzi Engine 插件的工程

您在合并具有相同名称但组件类型、数据源、消息或属性类型不同的Kanzi Engine 插件时，无法解决工程合并 (Project Merge) 工具中的冲突。

要合并含有冲突 Kanzi Engine 插件的工程：

1. 在 Kanzi Studio 中，打开未使用正确版本的 Kanzi Engine 插件的工程。
2. 在素材库 (Library) > Kanzi Engine 插件 (Kanzi Engine Plugins) 中，右键点击该插件并选择更新 Kanzi Engine 插件 (Update Kanzi Engine Plugin)。
   
3. 合并 Kanzi Studio 工程。请参阅合并工程。

合并包含使用本地存储数据的数据源的工程

通常情况下，您合并到 Kanzi Studio 工程的数据源中的数据由应用程序所连接的服务器提供。但如果您要合并的数据源的源文件存储在源工程本地，则必须以手动方式将它们从 <SourceProjectName>/Application/bin 复制到 <TargetProjectName>/Application/bin。如果您没有将数据文件复制到目标工程，则 预览 (Preview) 无法开始。

使用版本控制工具合并工程

配置版本控制工具后，您可以使用 Kanzi 合并工具进行 Kanzi 工程更新和合并。Kanzi 需要一个版本控制工具为 Kanzi 合并工具提供必要的参数进行集成。

将 Kanzi 合并工具与版本控制工具集成

要将 Kanzi 合并工具与版本控制工具集成：

1. 配置版本控制工具，以将 Kanzi 合并工具（<KanziInstallation>/Studio/Bin/KanziMergeTool.bat）用于 .kzproj 文件。
2. 将通往 KanziStudio.exe 的绝对路径传递给您的版本控制工具。例如，C:\Program Files\Rightware\Kanzi\Studio\Bin\KanziStudio.exe。
3. 设置 Kanzi 合并工具的版本控制工具参数。例如，这些参数可称为 MINE、THEIRS、BASE、MERGED。

将 Kanzi 合并工具与 SVN 版本控制软件集成

要将 Kanzi 合并工具与 SVN 版本控制软件集成，为外部合并文件程序 Kanzi 合并工具添加 .kzproj 扩展名。
例如，如果您在使用 Tortoise SVN，在 Tortoise SVN 中选择 SVN > 设置 > 外部程序 > 合并工具 > 高级，然后进行设置：

• 文件名、扩展名或 MIME 类型设为 .kzproj
• 外部程序设为
  

  <KanziInstallation>/Studio/Bin/KanziMergeTool.bat "<KanziInstallation>/Studio/Bin/KanziStudio.exe"  %mine %theirs %base %merged

  例如，如果 Kanzi 安装在 C:\Program Files\Rightware\Kanzi 中，则使用

  C:\Program Files\Rightware\Kanzi\Studio\Bin\KanziMergeTool.bat "C:\Program Files\Rightware\Kanzi\Studio\Bin\KanziStudio.exe" %mine %theirs %base %merged

将 Kanzi 合并工具与 Git 版本控制软件集成

要将 Kanzi 合并工具与 Git 版本控制软件集成，为外部全并文件程序 Kanzi 合并工具添加 .kzproj 扩展名。

例如，如果您在使用 TortoiseGit，则进行以下操作：

1. 复制 <KanziInstallation>/Studio/Bin/KanziMergeTool.bat 并将副本命名为“KanziMergeToolGit.bat”。
2. 打开 KanziMergeToolGit.bat 文件并移除以下内容，便可移除对 SVN 版本控制软件的引用：

   dir %MINE%
   svn resolve --accept working %MINE%
   )

3. 在 TortoiseGit 中选择“设置”>“不同视图”>

• 文件名、扩展名或 MIME 类型设为 .kzproj
• 外部程序设为
  

  <KanziInstallation>/Studio/Bin/KanziMergeTool.bat "<KanziInstallation>/Studio/Bin/KanziStudio.exe"  %mine %theirs %base %merged

  例如，如果 Kanzi 安装在 C:\Program Files\Rightware\Kanzi 中，则使用

  C:\Program Files\Rightware\Kanzi\Studio\Bin\KanziMergeToolGit.bat "C:\Program Files\Rightware\Kanzi\Studio\Bin\KanziStudio.exe" %mine %theirs %base %merged

另请参阅

导入工程

合并 3D 资产

工程

将版本控制系统用于 Kanzi

打开导航